Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add /rerank and /import sections to README #82

Merged
merged 4 commits into from
Oct 22, 2024

Conversation

aulorbe
Copy link
Contributor

@aulorbe aulorbe commented Oct 21, 2024

Problem

In anticipation of the upcoming major release, we need to update the Go README to incorporate sections for rerank and import.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update
  • Infrastructure change (CI configs, etc)
  • Non-code change (docs, etc)
  • None of the above: (explain here)

@aulorbe aulorbe marked this pull request as ready for review October 21, 2024 20:25
Copy link
Contributor

@austin-denoble austin-denoble left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for adding!

README.md Outdated

if err != nil {
log.Fatalf("Failed to create Client: %v", err)
} else {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: Let's drop the else here, I'd like to cut down on some of the verbosity in our Go documentation and stuff like this isn't really necessary.

I don't think we need the success messages for any of the errors below either.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

okie doke


errorMode := "abort" // Will abort if error encountered; other option: "continue"

importRes, err := idxConnection.StartImport(ctx, storageURI, nil, (*pinecone.ImportErrorMode)(&errorMode))
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The need to cast this errorMode pointer feels messy. I think updating the argument type so it's a bit easier to work with would be good.

You don't need to do anything here, and this is fine and accurate for now. Just made me realize - I added a ticket.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sounds good!


pc, err := pinecone.NewClient(pinecone.NewClientParams{
ApiKey: "YOUR-API-KEY"
})
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: Indentation may be off here.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks good on my screen; it's aligned with pc. What are you seeing?
Screenshot 2024-10-21 at 4 48 22 PM

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's just gh formatting, nevermind.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

okay cool!

@aulorbe aulorbe merged commit ce06d3f into release-candidate/2024-10 Oct 22, 2024
2 checks passed
@aulorbe aulorbe deleted the Audrey/README-updates branch October 22, 2024 17:17
austin-denoble pushed a commit that referenced this pull request Oct 23, 2024
## Problem

In anticipation of the upcoming major release, we need to update the Go
README to incorporate sections for `rerank` and `import`.

## Type of Change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update
- [ ] Infrastructure change (CI configs, etc)
- [x] Non-code change (docs, etc)
- [ ] None of the above: (explain here)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants